home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / games_d / deep815s.zip / DEACC.TXT < prev    next >
Text File  |  1995-12-05  |  2KB  |  88 lines
  1. DEACC.EXE v1.1 by Luc Cluitmans
  2.  
  3. This zipfile contains DEACC.EXE, my hexen script decompiler and
  4. this readme file.
  5.  
  6.  
  7. *USE*
  8.  
  9. Type 'DEACC' without arguments to get the usage info.
  10.  
  11. Examples:
  12.     DEACC sample.o > sample.acs
  13.     DEACC sample.o sample.acs
  14.     DEACC mywad.wad MAP01 map01.acs
  15.     DEACC mywad.wad MAP01 | more
  16.  
  17.  
  18. *About Decompilation*
  19.  
  20. DEACC tries to decompile hexen scripts into ACS files.
  21.  
  22. Some info that was in the original ACS source for the script is
  23. not available in the compiled form of the script: DEACC will not
  24. be able to recover this information. DEACC is not able to:
  25. - recover the original variable names
  26. - recover any comments
  27. - recover the exact source for constructs that can be written
  28.   in several ways. DEACC tries to generate 'break' and 
  29.   'continue' statements only if no other construct can be found.
  30.  
  31. I tested DEACC on all scripts of the original Hexen.Wad. The output
  32. it produces for each original hexen script was compilable by ACC.
  33. When ACC compiled the ACS files produced by DEACC, the resulting
  34. behavior lump was exactly equal to the original for all maps (the bug
  35. for MAP22 and MAP39 in deacc 1.0 has been fixed)!
  36.  
  37.  
  38. *Frequently Asked Question*
  39. Q: "Hey, I get an error when I try to decompile the behavior of
  40.     MAP07. What is going on?"
  41. A: There is no MAP07 in the original hexen wad! The other missing
  42.    numbers are: MAP14, MAP15, MAP16, MAP17, MAP18, MAP19, MAP20,
  43.    MAP29, and any MAPxy with xy>41.
  44.  
  45.  
  46. *Bugs*
  47.  
  48. None. Well, I know of some constructs that would not decompile
  49. correctly, but you probably will not encounter them :-).
  50.  
  51.  
  52. *Acknowledgements*
  53.  
  54. Thanks to:
  55. - Raven Software and id Software for creating Hexen
  56. - Ben Morris for the Hexen Specs
  57. - John B. Williston for getting me on the track of
  58.   hexen decompilation
  59.  
  60.  
  61. *History*
  62.  
  63. 21 November 1995
  64.     Released version 1.0 of DEACC
  65.  
  66. 05 December 1995
  67.     Version 1.1:
  68.     - fixed the string variable problem (DEACC 1.0 did not correctly
  69.       decompile scripts containing string variables, like MAP22 and
  70.       MAP39 in the original hexen wad).
  71.     - fixed a few small and barely noticable bugs. 
  72.  
  73.  
  74. *Updates*
  75.  
  76. Updates will be available from ftp.cdrom.com and its mirrors in
  77. the 'utils/level_edit/hexen_scripting' directory.
  78.  
  79.  
  80. *Feedback*
  81.  
  82. If you have comments or bug reports: send me  a message via email:
  83.    L.J.M.Cluitmans@ele.tue.nl
  84.  
  85.  
  86.     Luc.
  87.  
  88.